home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / dir / browser2.41 / parm / parm.docf < prev    next >
Text File  |  1993-08-12  |  33KB  |  713 lines
  1.  
  2.  
  3. Documentation pour ParM V4.5, SetMouse V2.1, parm.library V10.2
  4.  
  5.  
  6. **************************************************************************
  7. ****************************               *******************************
  8. ****************************   ATTENTION   *******************************
  9. ****************************               *******************************
  10. **************************************************************************
  11.  
  12.     Si  vous  possédez  une  version antérieure de ParM, et des outils qui
  13. utilisent  la  parm.library,  vous DEVEZ remplacer TOUS ces outils par les
  14. nouvelles  version fournies ici.  La nouvelle parm.library version 7 n'est
  15. pas compatible avec les precedentes.  Ce n'était pas possible.
  16. Comme  promis  dans  la  dernière version, ce nouveau ParM ne fonction que
  17. sous AmigaDOS 2.0 (V 37 ou plus).
  18. ParM n'a maintenant plus besoin des librairies arp et req. Merci le 2.0 !
  19.  
  20. **************************************************************************
  21. **************************************************************************
  22.  
  23.  
  24. ParM signifie Parametrable Menu.
  25.  
  26. ParM  vous  permet  de  construire  vos propres menus de manière à pouvoir
  27. lancer  tous  les  programmes  de  votre choix.  ParM est particulièrement
  28. utile  si  vous possédez un disque dur avec des programmes situés dans les
  29. profondeurs des répertoires.  Vous pourrez alors les lancer par une simple
  30. sélection  de menu et donc sans avoir besoin d'ouvrir tous les répertoires
  31. succéssifs aussi bien sous CLI que sous WorkBench.
  32. Avec  ParM, vous pouvez lancer vos programmes aussi bien en mode WorkBench
  33. qu'en  mode  CLI.   L'avantage du mode WorkBench est que le répertoire par
  34. défaut  de  votre  programme sera celui dans lequel le programme se situe.
  35. Mais tous les programmes ne peuvent être exécutés dans ce mode.
  36. ParM possède maintenant une SunMouse, économiseur d'écran, accélérateur de
  37. souris...   Nous  avons  décidé d'ajouter ceci à ParM car un input-handler
  38. était  déjà  présent  dans  la  parm.library,  cela  ne prendrait donc pas
  39. beaucoup de code suplémentaire, et nous avions 3 fenêtres dans la barre de
  40. titre  du  workbench.  Une pour l'accélérateur, une pour la mémoire, et la
  41. fenêtre inutile de ParM.  Maintenant, la fenêtre de ParM est utile, et est
  42. plus facile à activer pour l'accès aux menus vu sa plus grande taille.
  43.  
  44.  
  45. Comment utiliser ParM:
  46. ----------------------
  47.     Si  vous lisez cette documentation sans savoir exactement ce dont vous
  48. avez besoin, vous avez de grandes chances de vous y perdre au vu du nombre
  49. de  possibilités  offertes  par le paramétrage de ParM.  A la fin de cette
  50. documentation,  vous  trouverez une aide pour choisir un mode de lancement
  51. pour  chacune  de  vos  commandes suivant la version de KickStart que vous
  52. utilisez.
  53.  
  54.  
  55. Installation:
  56. -------------
  57.     Installez ParM et SetMouse avec leurs icones là où vous le désirez, et
  58.     mettez  le fichier de configuration ParM.cfg dans le répertoire S:  si
  59.     vous l'utilisez.  Sinon, vous devrez systématiquement spécifier le nom
  60.     du  fichier  config  sur la ligne de commande ou dans les TOOLTYPES de
  61.     l'icone de ParM.  Dans le cas contraire, vous devrez répondre l'alerte
  62.     signifiant  l'absence  de fichier config et vous n'aurez pas de menus.
  63.     Assurez vous bien d'avoir placé la parm.library dans votre LIBS:.
  64.  
  65.  
  66. Exécution:
  67. ----------
  68.     Il  est recommandé de lancer ParM depuis un CLI si vous voulez que vos
  69.     programmes aient un Path autre que le répertoire courant et C:  ce qui
  70.     est le cas si vous le lancez depuis workbench.
  71.  
  72.     ParM peut fonctionner de trois manières différentes:
  73.     1)  Vous  pouvez  attacher ParM à la fenêtre du CLI que vous utilisez.
  74.         Dans ce cas, si vous ne spécifiez aucune des options concernant la
  75.         fenêtre,  les  menus  seront  attachés  au  CLI depuis lequel vous
  76.         l'avez  lancé.  Il est préférable alors de lancer avec la commande
  77.         Run  et non  Run >NIL:  pour  vous  empêcher  de fermer le CLI par
  78.         inadvertance.
  79.     2)  ParM  peut  avoir  sa propre fenêtre.  C'est toujours le cas quand
  80.         ParM  est  exécuté  depuis  WorkBench,  mais vous pouvez aussi lui
  81.         demander  d'ouvrir  sa fenêtre quand vous le lancez depuis un CLI.
  82.         Pour  cela,  il  suffit  de  spécifier l'option OWNWINDOW ou toute
  83.         autre  option  ayant  rapport  avec  les  caractéristiques  de  la
  84.         fenêtre.   Dans  ce  cas,  vous devriez le lancer avec la commande
  85.         Run >NIL:  de manière  à  pouvoir  fermer  le  CLI  par  la suite.
  86.  
  87.     3)  ParM peut être rattaché aux menus du Workbench, comme MyMenu.
  88.  
  89.  
  90.     ParM a des options accessibles aussi bien sous WorkBench que sous CLI.
  91.     La  documentation  des  arguments est maintenant incluse dans ParM lui
  92.     même.   Entrez ParM ?, puis de nouveau ?.  Les arguments avec l'option
  93.     /s  sont  les interrupteurs (switches), et les arguments avec l'option
  94.     /k sont des mots-clé (keywords) et nécessitent un argument (un nombre,
  95.     ON ou OFF, un nom de fichier,...).
  96.     Depuis  le  workbench,  les mots-clé sont les mêmes.  Vous devez juste
  97.     ajouter =TRUE pour les /s, ou =Argument pour les /k.
  98.  
  99.     CLIWINDOW n'est pas disponible sous workbench.
  100.  
  101.     Aide CLI de ParM:
  102.  
  103. MYMENU/S,CLIWINDOW/S,OWNWINDOW/S,LEFTEDGE/K/N,TOPEDGE/K/N,DETAILPEN/K/N,BLOCKPEN/K/N,
  104. DRAGBAR/K,DEPTH/K,AUTOFRONT/K,SHOWMEM/K,SHOWTIME/K,REFRESHTIME/K/N,MTDETAILPEN/K/N,
  105. MTBLOCKPEN/K/N,MENUCOLOR/K/N,STACKSIZE/K/N,CONFIGFILE/K,USENULL/K: ?
  106.  
  107. ParM V4.2 © 1990-92 by S.R. & P.C.
  108. MYMENU            Rattache ParM au Workbench. (Comme MyMenu !)
  109. CLIWINDOW         Attache les menus à la fenêtre CLI/Shell.
  110. OWNWINDOW         Ouvre sa propre fenêtre
  111. LEFTEDGE          Position horizontale de la fenêtre (défaut 0)
  112. TOPEDGE           Position verticale de la fenêtre (défaut 0)
  113. DETAILPEN         Couleur du texte de la fenêtre (défaut 1)
  114. BLOCKPEN          Couleur de fond de la fenêtre (défaut 2)
  115. DRAGBAR   ON|OFF  Fenêtre déplaçable ou non (defaut: on)
  116. DEPTH     ON|OFF  Gadgets de profondeur (defaut off)
  117. AUTOFRONT ON|OFF  La fenêtre passe devant dès quelle est cachée (defaut: on)
  118. SHOWMEM   ON|OFF  Affiche la mémoire disponible (defaut off)
  119. SHOWTIME  ON|OFF  Affiche l'heure. (defaut off)
  120. REFRESHTIME       Intervalle de temps pour l'affichage de l'Heure/Memoire (multiple de 0.1s: defaut 1s)
  121. MTDETAILPEN       Couleur du texte pour Memoire/Heure (defaut: DetailPen)
  122. MTBLOCKPEN        Couleur de fond pour Memoire/Heure (defaut: BlockPen)
  123. MENUCOLOR         Couleur du menu principal (default: DetailPen)
  124. STACKSIZE         Taille de la pile par défaut pour les commandes (default: taille de la pile de ParM)
  125. CONFIGFILE        Fichier de configuration (defaut: S:ParM.cfg)
  126. USENULL   ON|OFF  Redirige les entrées/sorties des commandes à NULL: (ou NIL:) (defaut: off)
  127.  
  128.  
  129. Variable d'environnement ParMOpt:
  130. ---------------------------------
  131.     En  plus de la ligne de commande, vos paramètres préférés peuvent être
  132.     mis   dans  la  variable  d'environnement  Env:ParMOpt.   Vous  n'avez
  133.     recopier  tel  quel  vos  arguments  dans  un éditeur de texte sur une
  134.     ligne,  et  sauvegarder  ce  fichier  sous  le nom de Env:ParMOpt.  Ce
  135.     fichier  sera  alors  examiné  en  premier,  et  les  arguments CLI ou
  136.     WorkBench   ensuite,  lesquels  pouront  annuler  un  argument  de  la
  137.     variable.
  138.  
  139.  
  140. Fichier de configuration:
  141. -------------------------
  142.     Vous   comprendrez   mieux  ce  qui  va  suivre  avec  le  fichier  de
  143.     configuration fourni sous les yeux.
  144.  
  145.     Un  fichier  de  configuration ressemble à un programme structuré.  Il
  146.     est  recommandé  d'indenter  les  lignes  pour rendre ce fichier aussi
  147.     lisible  que possible.  Le fichier de configuration par défaut doit se
  148.     trouver  dans le répertoire S:  et nommé ParM.cfg.  Ce fichier définit
  149.     les  menus  que  vous  désirez  et les commandes correspondantes.  Les
  150.     commentaires commencent avec un '#' et continuent jusqu'à la fin de la
  151.     ligne.  Les majuscules/minuscules ne sont pas distinguées.
  152.  
  153.  
  154.     Mots clés:
  155.     ----------
  156.  
  157.     CMDWIN  console
  158.  
  159.         Cette  commande redéfinira la console par défaut utilisée par ParM
  160.         ("CON:0000/0011/0640/0100/Command window/AUTO/CLOSE/WAIT") pour la
  161.         fonction  Command.   Peut  être placé n'importe où dans le fichier
  162.         mais  il  vaut  mieux  le mettre au début.  Cette console sous 2.0
  163.         aura  un  gadget de fermeture (CLOSE), une ouverture différée à la
  164.         première  écriture  (AUTO),  et  attendra que vous cliquiez sur le
  165.         close-gadget avant de se refermer.
  166.         Attention: sous 2.0, si vous utilisez Command en mode Simple, vous
  167.         DEVEZ  ajouter l'option /WAIT à votre console ou elle se refermera
  168.         à la fin avant que vous ayez eu le temps de lire les resultats.
  169.  
  170.     SHELLWIN  console
  171.  
  172.         Cette  commande redéfinira la console par défaut utilisée par ParM
  173.         ("CON:0000/0011/0640/0100/Shell/CLOSE") pour les commandes en mode
  174.         SHELL sans spécification de fenêtre.  Peut être placé n'importe où
  175.         dans le fichier mais il vaut mieux le mettre au début.
  176.  
  177.     SHORTCUTQUAL qual
  178.  
  179.         Ceci   permet  d'ajouter  une  ou  plusieurs  touche  d'acces  aux
  180.         raccourci-clavier  pour les menus.  Par exemple Amiga-gauche, ALT,
  181.         ou encore SHIFT ou Control. Si vous desirez plusieurs possibilités
  182.         vous pouvez ajouter les codes si dessous.
  183.         Liste des codes:
  184.             SHIFT gauche    1
  185.             SHIFT droit     2
  186.             CONTROL         8
  187.             ALT gauche      16
  188.             ALT droit       32
  189.             Amiga gauche    64
  190.  
  191.         Si par exemple vous desirez que les deux touches ALT puissent vous
  192.         servir de touche raccourci, faites:         ( 16 + 32 = 48 ! )
  193.             SHORTCUTQUAL 48
  194.  
  195.         Si  vous  desirez  des  raccourcis sans qualifier, (lettre seule),
  196.         vous pouvez utiliser  32768  (IEQUALIFIER_RELATIVEMOUSE),  qui est
  197.         toujours  present dans les évennements de type RAWKEY. (Attention,
  198.         a utiliser avec précaution).
  199.         Ceci  ne marche que si ParM a sa propre fenêtre ou est rattaché au
  200.         Workbench, mais ne marche pas dans un CLI.
  201.  
  202.  
  203.     ACTIVATEKEY [SCREENTOFRONT] [PASSTHROUGH] [NOCHECK] qualifier rawkey
  204.  
  205.         Ceci permet de définir un "Hot-Key" pour ParM ou plus généralement
  206.         pour  tout  programme qui utilise les menus de la parm.library, et
  207.         donc "The great BrowserII" !
  208.         Attention, rawkey est le code de touche du clavier, et non pas le
  209.         code ascii du caractère généré par la touche.
  210.         Comme  son  nom  l'indique,  ceci  une  séquence de touches qui va
  211.         activer la fenêtre de ParM, et ceci avec trois options.
  212.  
  213.         Pour expérimenter les codes qui passent dans le handler, installez
  214.         la version 'debug' de la librairie dans LIBS:.
  215.         Méthode:
  216.             Assurez vous que parm.library ne soit pas en mémoire (Rebooter
  217.             si nécessaire).
  218.             Copy parm.library.debug libs:parm.library
  219.             Run ParM -w
  220.         Une fenêtre affiche alors dans l'ordre:
  221.             Class  SubClass  Code  Qualifier.
  222.         Ces codes sont en hexadécimal et seuls Code et Qualifier vous sont
  223.         utiles. Vous devez les transformer en décimal pour ParM.
  224.         Une  fois  les  infos  recueillies, réinstallez la version normale
  225.         de la parm.library.
  226.  
  227.         Options:
  228.             1. SCREENTOFRONT
  229.                 L'écran qui contient la fenêtre de  ParM  passera en avant
  230.                 plan.
  231.             2. PASSTHROUGH
  232.                 Ceci  risque  d'être  un peu délicat à comprendre pour les
  233.                 non-programmeurs.   Disons  que  si  vous ne spécifiez pas
  234.                 cette option, la séquence n'aura pour action que d'activer
  235.                 la  fenêtre.  Si vous la mettez, la fenêtre que vous venez
  236.                 d'activer  recevra  la  séquence  de  touche,  et si cette
  237.                 séquence  correspond  à  un  raccourci  clavier d'un menu,
  238.                 l'option  de  menu  sera  exécutée.   Ceci  est  donc très
  239.                 puissant  puisque  bien  paramétré,  cela  vous  permet de
  240.                 lancer  un  programme grace a ParM sans toucher la souris,
  241.                 même si la fenêtre de ParM n'est pas active.
  242.  
  243.                 Exemple:
  244.                 
  245.                     SHORTCUTQUAL 64                 (Amiga gauche)
  246.                     ACTIVATEKEY PASSTHROUGH 64 50   (Amiga gauche - X)
  247.  
  248.                     Menu System
  249.                         Item {X} Xoper RUN Xoper
  250.  
  251.                     Ceci permet de lancer Xoper à tout moment sans toucher
  252.                     ni la souris, ni ParM.
  253.  
  254.                 Autre exemple:
  255.  
  256.                     # Left ALT - Right Mouse Button
  257.                     ACTIVATEKEY PASSTHROUGH SCREENTOFRONT 8208 105
  258.  
  259.                     Ceci active la fenêtre ParM, et les Menus. Essayez.
  260.                     Plus besoin d'aller cliquer dans la petite fenêtre.
  261.  
  262.             3. NOCHECK
  263.                 La  librarie  maintient  une  liste des "Hot-Keys".  Quand
  264.                 vous  ajoutez  un  Hot-Key,  ParM controle qu'il n'est pas
  265.                 déjà utilisé.  Si c'est le cas, vous en serez averti et il
  266.                 ne  sera pas pris en compte.  Si vous spécifez NOCHECK, il
  267.                 sera  systématiquement  installé  en  tête  de liste, sans
  268.                 contrôle, et sera prioritaire sur l'ancien.
  269.                 Ceci  me  permet la chose suivante:  Un Hot-Key de ParM me
  270.                 charge  BrowserII.  Le même Hot-Key est déclaré en NOCHECK
  271.                 dans BrowserII.menu.
  272.                 Ceci  a  l'effet suivant:  Si BrowserII est chargé, il est
  273.                 activé  et  son écran passe en avant plan.  sinon, ParM le
  274.                 charge.
  275.  
  276.                 ParM.cfg :
  277.  
  278.                     SHORTCUTQUAL 64
  279.  
  280.                     # Left Amiga - Z   (Load BrowserII)
  281.                     ACTIVATEKEY PASSTHROUGH 64 49
  282.  
  283.                     menu Tools
  284.                         item {Z} BrowserII      RUN HD:Tools/BrowserII
  285.  
  286.                 BrowserII.menu :
  287.  
  288.                     SHORTCUTQUAL 64
  289.  
  290.                     # Left Amiga - Z
  291.                     ACTIVATEKEY SCREENTOFRONT NOCHECK 64 49
  292.  
  293.  
  294.     COLOR  n
  295.  
  296.         Après  cette instruction, les menus seront de la couleur n.  Cette
  297.         couleur  est  par  défaut  la  couleur  d'avant plan de la fenêtre
  298.         (detail  pen).  Si vous demandez la couleur de fond, alors ParM la
  299.         remplacera par la couleur du detail pen.
  300.  
  301.     MENU  nom_du_menu
  302.  
  303.         Créé  un nouveau menu.  Chaque menu doit contenir au moins un item
  304.         ou un sousmenu.
  305.  
  306.     SUBMENU  nom_du_sousmenu
  307.  
  308.         Créé  un nouveau sousmenu.  Chaque sousmenu doit contenir au moins
  309.         un item et ne peut avoir de sousmenu.
  310.         Chaque SUBMENU doit se terminer par un ENDSUBMENU
  311.  
  312.     ENDSUBMENU
  313.  
  314.         voir SUBMENU.
  315.  
  316.  
  317.     ITEM [{raccourci-clavier}] nom_de_l_item [WBTF] [REQUEST] definition_de_la_commande
  318.  
  319.         Definit  une  nouvelle  entrée  de menu.  Chaque definition 'item'
  320.         doit  avoir  un  nom  d'item et une commande associée.  L'item est
  321.         ajouté  au menu ou sousmenu courant.  Un ENDSUBMENU indique à ParM
  322.         la  fin  du sousmenu courant et d'ajouter le prochain item au menu
  323.         courant  plutôt  qu'au  sousmenu.   Un raccourci-clavier optionnel
  324.         peut  être  indiqué  entre  {}.   WBTF  est aussi optionnel.  Cela
  325.         permet  de  faire  passer  l'écran  du  workbench  devant pour les
  326.         programmes lancés depuis BrowserII et qui ouvrent une fenêtre dans
  327.         l'écran  du  workbench.   REQUEST  est  aussi optionnel.  Ouvre un
  328.         requester  dans  lequel  vous pouvez modifier la commande avant de
  329.         l'executer.  La syntaxe d'une commande est definie dessous.
  330.  
  331.         definition_de_la_commande
  332.  
  333.             Les  programmes  peuvent  être lancés de 3 façons différentes:
  334.             RUN,  SHELL,  et WB.  Pour tous les modes, STACK (pile) et PRI
  335.             sont optionnels.  Si la pile est < 4000 octets, la taille sera
  336.             celle  de la pile de ParM, c'est à dire, la pile par défaut du
  337.             cli  au moment où ParM a été lancé.  Il y a une exception:  si
  338.             ParM  est  résident,  la  pile  de  ParM sera toujours de 4000
  339.             octets.
  340.  
  341.  
  342.             2) syntaxe RUN
  343.  
  344.             RUN [WIN console] [STACK n] [PRI n] commande [args][;commande [args]]...
  345.  
  346.             Ce  mode  lance la commande en background shell.  Ce mode doit
  347.             être  utilisé  pour les scripts.  Si le bit s de votre fichier
  348.             script est mis, il sera exécuté automatiquement (Pas besoin de
  349.             la  commande  Execute).  Dans ce mode, les commandes ne seront
  350.             pas  détachées  si  ParM  est attaché à un CLI, sauf si vous
  351.             utilisez l'option USENULL.
  352.             Vos commandes peuvent être redirigées dans ce mode.
  353.             Vous pouvez mettre plusieurs commandes séparées par des ;
  354.             Ce mode fonctionne maintenant en 2.0,  cherche  les programmes
  355.             dans la liste des résidents Commodore (en 2.0) et permet aussi
  356.             l'utilisation d'une console (celle-ci est ignorée en 1.3).
  357.  
  358.  
  359.             3) syntaxe SHELL
  360.  
  361.             SHELL [WIN console] [STACK n] [PRI n] commande [args][;commande [args]]...
  362.  
  363.             Ce  mode  est maintenant identique au mode RUN, excepté que si
  364.             aucune  fenêtre  n'est  spécifiée, la fenêtre shell par defaut
  365.             (SHELLWIN) est utilisée.
  366.  
  367.  
  368.             WB [STACK n] [PRI n] commande
  369.  
  370.             Lance  la  commande  en  mode  WorkBench,  comme si vous aviez
  371.             cliqué  sur  son icône.  Attention, si vous spécifiez une pile
  372.             (STACK)  ici,  elle  prendra  le pas sur la pile indiquée dans
  373.             l'icône.   Votre  commande  risque  donc  de  planter  si vous
  374.             utilisez une pile trop petite.  Sachez ce que vous faîtes.
  375.  
  376.  
  377.             5) option CFG
  378.  
  379.             CFG Fichier_de_Configuration
  380.  
  381.             ParM  charge  le  fichier de configuration comme si vous aviez
  382.             fait  Open  dans  le menu ParM et sélectionné ce même fichier.
  383.             Très  utile  pour utiliser des fichiers config sur des disques
  384.             différents pour choisir les programmes de ces disques.
  385.  
  386.     BARLABEL
  387.  
  388.         Ajoute une barre entre le dernier item et le prochain.
  389.  
  390.  
  391.     Dans tous les modes à l'exception de WB, la commande est cherchée dans
  392.     la  liste des programmes résident puis dans le Path actif au moment ou
  393.     ParM  a  été  lancé.   Pour  connaître  ce Path, il suffit d'entrer la
  394.     commande  Path  dans le requester de la fonction Command du menu ParM,
  395.     ou d'ouvrir un shell depuis ParM, et de tapper la commande Path.
  396.  
  397.     Un fichier de configuration est donné en exemple.
  398.  
  399.  
  400. Commandes du menu ParM.
  401.  
  402.     Open:       Ouvre le sélecteur de fichier pour selectionner le fichier
  403.                 à charger.
  404.     Update:     Met  à  jour  les  menus  en  rechargeant  le  fichier  de
  405.                 configuration  courant.   Utile si vous avez mofifié votre
  406.                 fichier config pendant que ParM tourne.
  407.     Std Cfg:    Charge  le fichier config par défaut S:ParM.cfg.  Pratique
  408.                 après exécution d'une commande CFG.
  409.                 utilisez  PatchDOS,  vous  aurez  accès  aux ressources de
  410.     Command:    Permet  d'exécuter  une  commande  CLI.  Votre CMDWIN doit
  411.                 avoir l'option  /Wait  pour que vous ayez le temps de lire
  412.                 son contenu.
  413.     ChangeDir:  Change   le   répertoire  courant  de  ParM.   Toutes  les
  414.                 commandes  héritent  du  répertoire  courant  de ParM sauf
  415.                 celles lancées en mode WB.
  416.     Quit:       Pourquoi? ParM n'est il pas mignon!
  417.  
  418.  
  419. Commandes séparées:
  420. -------------------
  421.   End:
  422.  
  423.     La  commande  End  permet  de  fermer un shell dans lequel un ParM est
  424.     attaché.   End a besoin de EndCLI pour fonctionner.  S'il n'y a pas de
  425.     ParM  attaché  au  shell, End fera seulement un EndCLI.  End et EndCLI
  426.     peuvent  être  mis résident pour une rapidité maximale.  Grace à cette
  427.     commande,   vous   pouvez   mettre  ParM  dans  votre  CLI-Startup  ou
  428.     Shell-Startup  pour  avoir  des  menus  dans chaque CLI/Shell, et vous
  429.     pourrez  les  fermer  à  l'aide  de End à la place de EndCLI sans vous
  430.     soucier  de  ParM.   Attention:   N'utilisez  pas  cette commande avec
  431.     WShell  car  il  n'accepte  que sa version 'Built-in' de EndCLI.
  432.  
  433.  
  434.   ParMCD:
  435.  
  436.     ParMCD  change  le  répertoire courant du ParM attaché au CLI courant.
  437.     Sans argument, ParM prendra le répertoire courant du CLI.  Vous pouver
  438.     spécifier  le  répertoire  en  argument  à ParMCD.  Cette commande est
  439.     pure, vous pouvez la mettre en résident.
  440.  
  441.  
  442.   Remarqque:
  443.   ----------
  444.     Ces  commandes ne fonctionnent pas si vous utilisez DHOpts.  DHOpts ne
  445.     supporte  pas  le  packet  ACTION_DISK_INFO  quand ParM a installé ses
  446.     menus dans la console.  Ce n'est pas un bug de ParM.
  447.  
  448.  
  449. Limitations:
  450. ------------
  451.     Si une commande en mode RUN échoue, vous ne le saurez pas, si ce n'est
  452.     que vous ne la verrez pas fonctionner.  C'est un peu ennuyeux pour les
  453.     utilitaires qui ne se manifestent pas de manière visible à l'oeil.
  454.  
  455.     Quand  ParM  est attaché à un CLI, les commandes exécutées en mode RUN
  456.     ne  seront  pas détachées, c'est à dire que vous ne pourrez pas fermer
  457.     le  CLI  avant  que  ces commandes ne soient terminées.  C'est le même
  458.     problème que si vous aviez lancé votre commande avec la commande Run:
  459.             1> Run ma_commande
  460.     D'un  autre  coté,  ces commandes conservent la console comme fichiers
  461.     standards  d'entrée/sortie, et vous pouvez en tirer avantage.  Si vous
  462.     ne  voulez pas que votre CLI soit perturbé par l'affichage intempestif
  463.     de  ces  commandes,  vous  pouvez  les  rediriger  à NIL:  ou utiliser
  464.     l'option USENULL. Dans ce cas seulement, les commandes seront détachée
  465.     de votre CLI.
  466.  
  467.  
  468. Bugs connues: (ou devrais-je dire boggues!)
  469.  
  470.     En mode SHELL, PRI n'est pas pris en compte. La priorité est toujours 0
  471.  
  472.  
  473. Projets d'amélioration:
  474.  
  475. -   Localisation. (Francisation en particulier!).
  476.  
  477.  
  478. Historique:
  479.  
  480.     1.0:    Interne. Refonte de MyMenu.
  481.  
  482.     1.1:    Première version officielle. (Envoyée à Fred Fish)
  483.             Ancien mode CLI changé en RB (RunBack)
  484.             Nouveau mode CLI ajouté.
  485.             Syntaxe du fichier de configuration changée.
  486.  
  487.     1.4:    Interne. Options -l, -d, et WBRun améliorées.
  488.             Vous   pouvez   maintenant  lancer  des  projets  en  mode  WB
  489.             constitués  d'une  icône  seulement.   Ex:  Serial, Pointer et
  490.             Printer de répertoire Prefs.
  491.  
  492.     1.6:    Seconde version officielle. 29/09/90.
  493.             Code réarrangé.
  494.             Nouvelle option CFG ajoutée.
  495.             Nouvelle fonction 'Std cfg' ajoutée.
  496.  
  497.     1.7:    Interne.
  498.             N'utilise plus la c16.lib, mais les miennes à la place.
  499.             Taille du code diminuée de 1.5 K.
  500.  
  501.     2.0:    Troisième version officielle. 13/10/90.
  502.             ParM peut maintenant être mis résident.
  503.             Commande End crée.
  504.             Le path est indiqué dans Change Dir.
  505.  
  506.     2.1:    Commande ParMCD crée.
  507.     2.1r:   Cette version utilise la librairie req.library (r pour req!).
  508.  
  509.     2.2r:   Disparition  des  modes  RB  et  CLI.  les nouveaux modes sont
  510.             ARUN,  RUN  et  SHELL.
  511.             STACK  et  PRI  sont  optionnels  pour tous les modes sauf WB.
  512.             Plus  besoin de la commande Run du répertoire C:.
  513.             Les  erreurs  de  syntaxe  du  fichier  de  configuration sont
  514.             maintenant reportées sous forme de ligne, colonne.
  515.  
  516.     2.3r:   Disparition du message 'Workbench processes still active'.
  517.             ParM  crée  maintenant  un  MsgPort  public  pour les messages
  518.             workbench commun à tous les ParM, et le laisse si des messages
  519.             sont encore en attente quand vous quittez ParM.
  520.             Maintenant,  si  votre console possède un gadget de fermeture,
  521.             vous  pourrez  quitter  ParM en le cliquant.  Particulièrement
  522.             utile pour les heureux possesseurs de WShell.
  523.             Les caractères de valeur ascii > 127 sont supportés (accents).
  524.             WAITCMD ajouté.
  525.  
  526.     2.4r:   Mode WB réécrit. STACK et PRI optionnels dans tous le modes.
  527.             Le  mode  WB  ne plante plus si la commande n'est pas trouvée.
  528.             Vous  pouvez  maintenant  lancer  des programmes qui n'ont pas
  529.             d'icône.
  530.             La  mémoire  pour les menus est allouée par blocks de 1 K pour
  531.             diminuer la fragmentation de la mémoire.
  532.  
  533.     2.5r:   Options -s et -o ajoutées.
  534.             -s  est utile si ParM est résident car dans ce cas, la pile de
  535.             ParM  est toujours de 4000 octets, alors qu'il prend la taille
  536.             de  pile  du CLI normalement.  Comme les commandes lancées par
  537.             ParM  prennent  par  défaut la taille de pile de ParM, -s vous
  538.             permet  d'avoir une pile par défaut autre que 4000 octet quand
  539.             ParM est résident.
  540.  
  541.     2.51r:  Mise à jour mineure. Correction de quelques bugs.
  542.             ParM  ne  plante  plus  quand  lancé  depuis  le  workbench en
  543.             l'absence de l'arp.library.
  544.  
  545.     2.6r:   ParM est maintenant implementé en librairie. Cela permet a
  546.             BrowserII de profiter de la creation de menus paramétrables de
  547.             ParM. Installez "parm.library" dans LIBS:.
  548.             La fenêtre de ParM passe maintenant à l'avant plan si elle est
  549.             complètement recouverte par une autre fenêtre. (Option ajoutée
  550.             a la demande d'utilisateurs).
  551.  
  552.     2.7:    L'  option  -o  utilise maintenant le gestionnaire NULL:  à la
  553.             place  de  NIL:   si  possible.   Cela permet d'éviter que des
  554.             programmes  ouvrant  le  fichier "*" plantent si le CLI depuis
  555.             lequel  ParM a été lancé a été fermé.  Avec NULL:, le mode RUN
  556.             est  maintenant  sûr et devrait fonctionner dans tous les cas.
  557.             Si  NULL:  n'existe pas, NIL:  sera utilisé.
  558.             'r'  enlevé  de  la  version.   Une version n'utilisant pas la
  559.             req.library n'est plus planifiée.
  560.  
  561.     2.8:    Correction de quelques bugs.
  562.             Le qualifier pour les raccourcis-clavier rendu parametrable.
  563.  
  564.     2.9:    Implementation d'un input handler dans parm.library. Cela rend
  565.             possible  le  lancement d'une commande sans toucher la souris,
  566.             ou  d'activer  les menus sans prealablement activer la fenêtre
  567.             de ParM.
  568.  
  569.     3.0:    Suite  à  la demande d'utilisateurs, ParM peut maintenant être
  570.             rattaché au Workbench,  comme MyMenu.  (Code pris a MyMenu une
  571.             fois de plus). Desolé et Merci, Darin et John.
  572.             ParM  est  maintenant  compatible avec Console-Buffer.  Il y a
  573.             néanmoins une limitation.  Vous devez installer ParM APRES CB,
  574.             et vous ne devez pas quitter CB avant ParM.
  575.             Possibilité de mettre plusieurs commandes séparées par un ; en
  576.             mode RUN et dans Command comme en mode SHELL.
  577.  
  578.     3.1:    Correction d'erreur dans les coordonnées de menu workbench.
  579.  
  580.     3.2:    Première version du SunMouse/Accélérateur de souris...
  581.  
  582.     3.3:    Input-Handler réécrit. Appels à intuition fait depuis une tache
  583.             séparée (pour éviter les 'dead-locks').
  584.  
  585.     3.4:    L'input handler et le mode RUN fonctionnent maintenant sous 2.0
  586.             Modes video VGA et SuperHiRes pas encore gérés.
  587.             La commande shell par défaut et maintenant NewShell (pour le 2.0)
  588.             Les consoles par defaut ont des spécifications 2.0.
  589.             Command en mode Simple est asynchore et gère les input et CTRL-C
  590.             correctement.
  591.             SetMouse V1.1. Ajout d'un Qualifier optionnel supplémentaire
  592.             pour les 'Window To Front'.
  593.  
  594.     3.5:    Correction d'erreur. (incompatibilité entre USENULL et CLIWINDOW).
  595.  
  596.     3.6:    Correction d'erreur en démarrage workbench.
  597.             ParM peut maintenant être attaché au workbench 2.0.
  598.             Vous n'avez plus besoin de NULL: sous 2.0.
  599.             En 2.0, vous pouvez utiliser une console pour le mode RUN.
  600.  
  601.     4.0:    Interne. Première version spécifique pour le 2.0.
  602.             Plus besoin des libraries arp et req.
  603.             Le handler de SetMouse gère toutes le résolutions d'écran.
  604.             La parm.library n'est pas compatible avec les précédentes.
  605.             SHELLCMD, WAITCMD, TMPDIR supprimées. Supprimez les de votre
  606.             config actuelle.
  607.             Plus besoin de la commande WaitReturn, avec l'option /Wait des CON:
  608.             ParM ne peux plus être résident. Qui l'utilisait ?
  609.  
  610.     4.1:    Possibilité d'insertion de BarLabel dans les menus.
  611.             Correction d'erreur dans la gestion des accents. Plus besoin de
  612.             guillemets.
  613.  
  614.     4.2:    Ajout des options REQUEST et WBTF.
  615.             Correction d'erreurs:
  616.                 Tags pour NewCreateProc() identiques au Workbench dans WBRun().
  617.                     (More 37.4 plantait en mode WB).
  618.                 Input Handler initialisé dans la ParMHandlerTask.
  619.                 Argument cli CONFIGFILE/K ne fonctionnait pas.
  620.                 Arguments cli numériques passés en /N
  621.             Première version spéciale AmigaDOS 2.0.
  622.  
  623.     4.3:    Localisée, donc en Français.
  624.  
  625.     4.4:    Gère la Pile spécifiée dans les icônes Projet.
  626.             Nouvelle option NEWLOOKMENUS pour AmigaDOS 3.0. Ceci enleve
  627.             la possibilite de personnaliser les couleurs des menuitems,
  628.             mais améliore l'affichage inverse-video pour les ecrans ayant
  629.             plus de 8 couleurs.
  630.  
  631.     4.5:    SHOWMEM affiche la ram disponible de la carte 24 bits Retina
  632.             si vous en avez une! :-)
  633.  
  634.  
  635. Comment utiliser ParM:
  636. ----------------------
  637.         Maintenant que vous avez lu tout ce dont ParM était capable, je
  638.     pense que vous aimeriez savoir quel mode de lancement vous devez
  639.     utiliser pour vos différents programmes.
  640.  
  641.     Premièrement, quand vous voulez ajouter une entrée de menu, vous
  642.     devez savoir:
  643.  
  644.     1) Votre programme peut-it être lancer sous workbench ?
  645.     2) Voulez vous que votre programme hérite du directory courant de ParM
  646.        ou doit-il avoir le sien ?
  647.     3) Votre programme doit-il avoir un Path ?
  648.     4) Votre programme a-t-il besoin d'une console ?
  649.  
  650.  
  651.     KickStart 2.0:
  652.     --------------
  653.         Les modes ARUN et SHELL sont obsolètes en 2.0.
  654.         Le choix entre les modes RUN et WB est donc simple.
  655.         Si vous avez besoin d'un path ou d'une console, utilisez le mode RUN.
  656.         Sinon, vous pouvez utiliser le mode WB.
  657.  
  658.  
  659. SetMouse:
  660. ---------
  661.     SetMouse s'emploie sans difficultés particulières. Tous les utilitaires
  662.     de ce genre fonctionnent de la même manière.
  663.  
  664.     WToFront Qual:
  665.         Touche à maintenir pendant le double-click pour que la fenêtre
  666.         passe devant.
  667.     
  668.     L'économiseur d'écran coupe la DMA. La priorité du handler peut être
  669.     modifiée en cas de problème de compatibilité avec d'autres. Celle-ci
  670.     ne sera prise en compte qu'au prochain chargement de la library, c'est
  671.     à dire au prochain reset.
  672.  
  673.     Remarque: Les options de souris seront actives tant que la parm.library
  674.     aura au moins un utilisateur (BrowserII, ParM, ou SetMouse actuellement).
  675.  
  676.  
  677. Remerciements:
  678. --------------
  679.     La  première  version  de ParM (interne) était une refonte complète de
  680.     MyMenu de Darin Johnson.  Le problème était qu'il n'était pas possible
  681.     d'avoir  MyMenu sans le workbench, et que les programmes lancés depuis
  682.     MyMenu n'avaient pas de Path.
  683.     Un grand merci donc à Darin Johnson pour les allocations de menu et le
  684.     workbench  run.   L'idée  d'attacher des menus au CLI m'est venue d'un
  685.     ami   qui   avait  fait  un  programme  similaire  mais  peu  pratique
  686.     à configurer.
  687.  
  688.     Merci à Darin Johnson pour MyMenu.
  689.     Merci à William S. Hawes pour ARexx et WShell.
  690.     Merci à Pierre 'Zorglub' Ardichvili pour son aide.
  691.     Merci  à  CygnusSoft  et  ASDG  pour  leur fabuleux, génial, démoniac,
  692.     démentiel, extraordinaire, divin,...  éditeur de texte CygnusEd 2.
  693.  
  694.  
  695. Signature:
  696. ----------
  697.     S.R. & P.C.
  698.     Ce n'est pas Status Register et Program Counter mais
  699.     Sylvain Rougier & Pierre Carrette.
  700.  
  701.  
  702. Donnations:
  703. -----------
  704.     Ce  programme  n'est  pas domaine public.  Ce programme est ShareWare.
  705.     Si  vous  l'utilisez,  veuillez  envoyer  50FF  (100FF  pour  ParM  et
  706.     BrowserII) et/ou constatation de bugs à:
  707.  
  708.         Sylvain Rougier
  709.         39 rue Carnot
  710.         86000 Poitiers
  711.         France.
  712.  
  713.